home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / sstrim11.zip / SSTRIM.DOC < prev   
Text File  |  1994-04-05  |  3KB  |  60 lines
  1. SSTRIM Version 1.1                Copyright (c) Stanley Schweitzer, 1994
  2.  
  3. SSTRIM removes trailing spaces from each line in a text file.
  4. There are three ways SSTRIM may be used.
  5.  
  6. 1. Input and output files may be specified on the command line:
  7.          SSTRIM InFile OutFile
  8.  
  9. 2. SSTRIM may be used as a filter:
  10.          SSTRIM <InFile >OutFile
  11.  
  12.    Each of the above commands reads InFile, and either replaces an
  13.    existing OutFile, or creates a new OutFile. InFile is not changed.
  14.  
  15. 3. SSTRIM may be used to trim a file in place:
  16.          SSTRIM File
  17.  
  18.    For the above command, the trimmed version of File is written
  19.    over the original File. No additional disk space is used.
  20.  
  21. If /? is anywhere on the command line, or no files are specified, a
  22. help message is displayed.
  23. __________________________________________________________________________
  24.                       Definitions and Limits
  25.  
  26. A line is a sequence of characters ending in a carriage return
  27. (ascii 13), a control-z (ascii 26), or the end of the file.
  28.  
  29. Files may be any size up to 4 Gigabytes. There is no limit on the
  30. length of the lines in a file, or the number of spaces in each line.
  31. __________________________________________________________________________
  32.                                Notes
  33.  
  34. Files may be specified by any combination of redirection or appearing on
  35. the command line. These four commands are equivalent:
  36.          SSTRIM InFile OutFile
  37.          SSTRIM InFile >OutFile
  38.          SSTRIM <InFile OutFile
  39.          SSTRIM <InFile >OutFile
  40.  
  41. If no output file is specified, the action taken depends on how
  42. the input file is specified:
  43.          SSTRIM <File            trimmed File is sent to standard output
  44.          SSTRIM File             File is replaced by trimmed File
  45.  
  46. File may be a device. For example:
  47.          SSTRIM File prn         trimmed File is sent to the printer
  48.  
  49. Warning: Do not redirect output to con if a file is specified on the
  50. command line. Since DOS strips the redirection before SSTRIM sees it,
  51. the result will be the same as if there were no redirection to con.
  52.          SSTRIM File >con        File is replaced
  53. Instead, use either of these commands:
  54.          SSTRIM File con         trimmed File is sent to the screen
  55.          SSTRIM <File [>con]     trimmed File is sent to the screen
  56. __________________________________________________________________________
  57. SSTRIM is freeware and freely distributable.
  58. Stanley Schweitzer
  59. stans@princeton.edu
  60.